home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / laston55.zip / LASTON.DOC < prev    next >
Text File  |  1993-01-21  |  20KB  |  363 lines

  1.  
  2.                         LASTON  Version 5.5
  3.                Copyright 1991-1993 Douglas DeLonay
  4.                     SYSOP of The Home of ZIGGY
  5.                            (414)264-3220
  6.  
  7.     Graphics screen design-there are now 3 user definable screens for
  8.     LASTON. They consist of 3 lines each..
  9.     in following format....
  10.  
  11.     *****name/handle**************From*******baud*****time-on***Date**
  12.     *                  *                  *        *          *      *
  13.     ******************************************************************
  14.     ^                  ^                  ^        ^          ^      ^Column 68
  15.  line 1            column 21          column 41   column 50   column60
  16.      the 3 files are named LASTON.ANI, LASTON.ASC, and LASTON.SCR..
  17.   The above would be an example of a screen design for no graphics.
  18.   The screen must be 68 colomns and 3 rows to show what you want to
  19.   surround the information about last callers..No more than 3 lines!
  20.     For the ASC and ANSI screens you should first design your ASC screen
  21.   as above.. when you got it the why you want it you can start adding the
  22.   color codes for the ANI screen.. Use a ANSI draw program such as THEDRAW
  23.   to add color to the ASC file to make it a ANSI file. Only Normal ANSI is
  24.   allowed. No animation.
  25.              make sure you have NO SPACES in the first and last lines of
  26.   the screen as that will throw your screen out of wack..
  27.                   also remember 68 colomns and the spaces between info
  28.   dividers...  look at the included sample screens to help guide you..
  29.        only 3 lines each!
  30.          If you change the files make sure you remove the old files from the
  31.   PATH!!
  32.    For easy setup use the SETUP command line parameter. This will make your
  33. .CFG files(s) for you. Easy to follow menu's and selections. Can also edit your
  34. .CFG files, and make/edit your .BAT files for you. the SETUP procedure will
  35. make your LASTON commandline from the options you pick in SETUP menu's. Though
  36. the SETUP utility should be easy to follow that doesn't mean you shoulnd't read
  37. the DOCS for a better understanding of commands. Type from directory LASTON
  38. will be run (can be run from other directory, but that isn't the safest way)
  39.  
  40.   LASTON SETUP
  41.  
  42.  
  43.                       the PAUSE command. This command will pause
  44.   the output at the end of display for remote callers. Since the main.mnu of
  45.   RyBBS does not put a PRESS ENTER prompt at the return from a program call
  46.   this command will solve that problem. If you run from the bulletin
  47.   menu (first.bbs) you won't need this. dorinfo1.def users may find this useful
  48.   also.
  49.      LASTON PAUSE
  50.  
  51.   Also new in 5.4 is the FOSSIL and FOSSILU commands. LASTON will now use a
  52.   fossil driver if you wish. when using the fossil commands LASTON will try and
  53.   use a fossil driver if resident. If LASTON can't find and init the driver it
  54.   will attempt to use it's own internal port interrupt routines. The difference
  55.   between the 2 commands are the following.
  56.       LASTON FOSSIL       -Will leave fossil active on port when it exits
  57.       LASTON FOSSILU      -Will unload fossil on exit(deactivate port),
  58.                            and leave fossil resident
  59.  
  60.     Work on com routines for better responce on high speed modems.
  61.     also changed the multi-node commands a bit, see appropriate section,
  62.                          and/or new.doc
  63.  
  64.   Now will display node number if use multi-node BBS.
  65.  
  66.     Fix bug were MNP connections would list
  67.   as local connection. Add another commandline option LOCKEDRATE. If you have a
  68.   high speed modem and want to use the lockedrate add this to the commandline
  69.   line.
  70.  
  71.       LASTON LOCKEDRATE
  72.  
  73.        Otherwise it will use the actual connectrate. It always used the
  74.   lockedrate before if you had a high speed modem and locked the port. Another
  75.   big benifit is the ability for you to pause, stop output even if a remote
  76.   user is on. Hitting <ENTER> will now continue output also to be more like
  77.   RYBBS screen output.
  78.  
  79.      LASTON can now use the DORINFO1.DEF file!.. DORINFO1.DEf users can
  80.   disregard the LASTON.SCR (comment file, look ahead) as DORINFO1.DEF only
  81.   detects for 2 choices-ANSI or not ANSI. Only the *.ANI and *.ASC screen files
  82.   apply to DORINFO1.DEF users. Still need both LASTONCM.* files.
  83.     Some of the commands listed do not apply to dorinfo1.def users. Commands
  84.   that DO NOT apply to DORINFO1.DEF users will have a "**" next to them.
  85.  
  86.        It will build a LASTON.DAT file from the dorinfo1.def file, adding to it
  87.   untill it reaches the default 10 users for unregistered version. You'll have
  88.   to run it a few times as above before you notice the laston screen starts to
  89.   build. You will have to run it as above as a log-on program to keep an
  90.   updated callers list. You can also run it at a menu for users to view without
  91.   updating the callers log- refer to the MENU command below.
  92.  
  93.     If you don't use the DAT file and get an MOT ENOUGH USERS IN CALLERS.LOG
  94.   message you can use the LOGP/n command to increase the amount of the
  95.   callers.log the program reads. By default LASTON has n=5, which means it
  96.   reads 500 bytes for every user you list in LASTON. In the unregistered
  97.   version it starts reading 5,000 bytes from the end of the file. The default
  98.   setting should be good for most setup's. If you get the above mentioned error
  99.   try testing it at slightly higher setings till the error disappears. you
  100.   might try something like
  101.  
  102.         **         LASTON LOGP/7
  103.  
  104.     If you have very small amount of events and startup's and shutdowns you
  105.   could try decreasing the the number to increase speed, though I wouldn't
  106.   recommend lowering it. Decreasing it wouldn't increase speed that much. A
  107.   setting of LOGP/0 would read the entire file. Setting it too high will also
  108.   read the whole file, say you set n=400 and your callers.log has only 300,000
  109.   bytes in it. If you use the DAT command you don't need to worry about this.
  110.   It will read the entire CALLERS.LOG the first time to set up the LASTON.DAT
  111.   file, and after that it doesn't need the callers.log anymore.
  112.  
  113.     More versatility for LASTON!!.. The LASTON.DAT file is back, but only if
  114.   you want it!! To use the LASTON.DAT file just enter DAT on the LASTON command
  115.   line, as follows
  116.  
  117.           **       LASTON DAT
  118.  
  119.     This will cause LASTON to make a LASTON.DAT file on the first run then read
  120.   and update it thereafter. The major benifit to using the DAT file option is
  121.   speed. On my XT for the default 10 user list it cut the display time by 2-3
  122.   seconds, which is a pretty decent percentage. Of coarse the disadvantage
  123.   (to some) is that you have to run it in FIRST.BAT (log-on batch file) to
  124.   update the LASTON.DAT file.
  125.     Of coarse since the .DAT file is back the MENU command is back also. When
  126.   using the .DAT file and you want to run LASTON from a menu you must put the
  127.   command on the LASTON command line. as follows, The MENU command assumes use
  128.   of the LASTON.DAT file
  129.  
  130.              LASTON MENU
  131.  
  132.           You can add a 3 line comment to LASTON.. this is optional. To add
  133.   a comment simple write a 1 to 3 line file in exactly the form you want it to
  134.   appear. LASTON will not center, and spaces are accepted. To make an ANSI
  135.   comment simple use THEDRAW or similar program to add colors and attributes
  136.   you want. The file names are LASTONCM.SCR for the pure text or ascii file,
  137.   and LASTONCM.ANI for the ANSI comment file. To have LASTON add the comments,
  138.   just add COMMENT to the command line..  NO ANIMATION lowed in ANSI files!!
  139.  
  140.            i.e.     C:\RYBBS\LASTON COMMENT
  141.  
  142.     The Time display has the option to display in 24 hour military format,
  143.   or in the 12 hour AM/PM format. AM/PM format is on by default.to change to
  144.   24 HR format just add "24HR" to the command line. i.e.
  145.  
  146.              C:\RYBBS\LASTON 24hr
  147.  
  148.     LASTON has a screen pause option. Just add Pn to the command line to
  149.   to pause screen at end of display n seconds. i.e.
  150.            LASTON P5
  151.       will pause screen approximately 5 seconds after screen is displayed.
  152.   default is o seconds.
  153.     LASTON screen is now user abortable. NEW (P)ause, (C)ontinue, or (S)top
  154.   option to accomadate those speed demon users!... SYSOP can also pause, stop
  155.   the display for a remote user if local echo is on.
  156.  
  157.      Laston will show as many callers as memory and size of callers.log will
  158.      allow to your system in the form..(DORINFO1.DEF users doesn't use
  159.      callers.log).
  160.  
  161.           Name   * City state  * baud rate * time logged on*Date(month and day)
  162.      for multi-node version node number will be displayed before name in first
  163.      column like so
  164.  
  165.      1   Name    *City State..etc. etc.
  166.  
  167. **   LASTON will now adjust the number of users shown if callers.log doesn't have
  168.      enough users, or memory isn't sufficient to list amount of callers you specify.
  169.                Must register to change amount of callers listed.
  170.                 unRegistered form will show the last 10 callers
  171.  
  172.      The DOS command line option allows for easy run from DOS without playing
  173.   with curruser.bbs(x). Will make your LASTON.CFG file for you registered users.
  174.     unregistered users can still make one and be ready when they register. Will
  175.   give you the option to use default CURRUSER.BBS(x) or DORINFO1.DEF file..
  176.   Curruser.bbs file is whatever file from last user is. curruser.x is hard coded
  177.   in the program. It will no longer show the caller that has just logged on as
  178.   the last user on.
  179.  
  180.   A command line option in the registered and unregistered version
  181.   is the local screen off mode... put OFF in the command line to stop echo
  182.   to local screen.. will still show on local screen when you are on locally.
  183.   to turn off local echo just put in FIRST.BAT (or menu .bat file) file
  184.   like so..
  185.  
  186.  
  187.               LASTON OFF
  188.  
  189.  
  190.   Local echo is on by default..I would recomend having it off if you run
  191.   a XT since this will speed up the display to your users..
  192.      In the registered version you will need to make a .CFG file.
  193.                 If you want the options that is.
  194.      call it LASTON.CFG  < use DOS command line option to make this file.>
  195.             C:\RYBBS\CURRUSER
  196.             0
  197.             The Home of ZIGGY
  198.             yellow,
  199.             cyan,
  200.             magenta,
  201.             cyan,
  202.             white,
  203.             red,
  204.             green,
  205.             101
  206.             4 mNEW/d,5 e
  207.  
  208.  
  209.    The first line is to tell RyBBS the path and filename of door file you're
  210.    using. RyBBS SYSOP's enter just filename without extension. DORINFO1.DEF
  211.    file users enter enter filename and extension.
  212.      the second line is for your registration number which activates the rest of
  213.    the registered options.
  214.      the third line is for your BBS name. whatever you put here will replace
  215.    the <UNREGISTERED> string in the header when registered.
  216.    The fourth line is the color your BBS name will be displayed in.
  217.    the fifth line is the Name color.
  218.    the sixth line is the City,State color.
  219.    the seventh line is the baud rate color.
  220.    the eighth line is the time called color.
  221.    the ninth line is for the DATE color.
  222.    the tenth line is for the node color.
  223.    the eleventh line is maximum amount of users to list in LASTON.dat.
  224.       it shoule be one more than the maximum you want to display. Enter a
  225.       number even if you don't plan on using the LASTON.DAT file option.
  226.    the twelfth line is for choosing display options by security.. you can chose
  227.      to not have certain security level entered in the list-'e' command.
  228.      to not have the screen display to certain users-'d' command.
  229.      to have users marked as '-NEW'-'m' command.
  230.         NEW.. you can now mark as anything you want.. to mark as new just type
  231.         in NEW right after the 'm' command ending the string with a '/'.. to
  232.         mark a certain security as a subscriber you might enter 'mSUB/' as part
  233.         of the display option for the security level...make it short as the
  234.         name will get truncated to make room for the string you enter to mark
  235.         the user security with. Maximum length accepted is 10 characters.
  236.      there is a 255 character limit to the amount of security selections you
  237.      can make. it must be in the format above.. security level followed by a
  238.      space followed by display options followed by a comma if there is more
  239.      security selections. if you make no selection just enter a 0 with no
  240.      preceding characters or characters following it.
  241.  
  242.    the colors accepted are-
  243.      foreground colors -Blackf, redf, greenf, yellowf, bluef, magentaf
  244.        , cyanf, and whitef
  245.      background colors -Blackb, redb, greenb, yellowb, blueb, magentab
  246.        , cyanb, and whiteb
  247.      action commands -off, bold, reverse, blink.
  248.        off turns off all ansi attributes, bold makes colors bright, reverse is
  249.        reverse video, and blink makes text blink. Any attributes added are in
  250.        effect for selected field only. All ansi color and action commands must
  251.        be followed by a comma(,), including the last one. i.e. to make a field
  252.        blink blue you would put
  253.                 blink,bluef,
  254.           the colors must be spelled correctly as above with no extra spaces or
  255.      punctuation allowed!
  256.  
  257.              also the option to change the # of users the program shows.
  258.   as many users as your memory capacity will allow with the registered version!
  259.  
  260.     LASTON /15 OFF
  261.     MUST have the '/' before number of callers to display with no spaces.
  262.     this will list 15 callers and turn off local echo... 10 callers is on
  263.     by default. Unregistered users don't get this command line option-get
  264.     default 10 user listing.
  265.       The screen will clear on the local screen when RyBBS regains control,
  266.     but remains on the remote screen. When on locally the screen will pause
  267.     till you hit <ENTER> to give you a little time to look it over.
  268.  
  269.                           LASTON DOS
  270.  
  271.       Use the DOS parameter to run from dos when setting up screen etc.. Also
  272.     will ask you if you want to create a .CFG file.. This is only needed for
  273.     Registered version. When you get your registration number use the DOS
  274.     parameter and answer yes to set up .cfg file. Fill it out EXACTLY as asked
  275.     and it will create your LASTON.CFG file for you.
  276.      The program will search for these files(CURRUSER.BBS, CALLERS.LOG,
  277.     LASTON.CFG) in the currrent dir and in the path.
  278.        LASTON /35 OFF     -unregistered version leave out '/35'..
  279.     This would list the last 35 callers to the remote user and turn off local
  280.     echo...
  281.  
  282.        LASTON now has direct node support. All you need is the LASTON command
  283.     line and when run from firt.bat and menu batch file use %1NODE on the
  284.     command line! You must have %node in the menu command line to pass node
  285.     number, dorinfo1.def users refer to your docs for the correct syntax for
  286.     you to pass node number.
  287.        srun,5,5,  [P]revious callers,*LASTON %node       -menu for RyMULT
  288.  
  289.              LASTON %1NODE                               -batch file
  290.              LASTON NODE                                 -DORINFO1.DEF users
  291.  
  292.        SHARE.EXE must be loaded for the Multi-node version to work. Supports
  293.     file-locking.
  294.  
  295.        In the batch file for RyMULT users only use %1NODE batch file. Must have
  296.     something listed in first line of LASTON.CFG file for LASTON to find the
  297.     correct node correctly, without it it will assume single user and abort
  298.     when a CURRUSER.BBS(x) isn't  found.. i.e.
  299.          You must use a post V6.8 RyBBS RyMult for it to work from FIRST.BAT
  300.     as 6.8 and earlier does not pass the NODE number to FIRST.BAT . For it to
  301.     work correctly from menu RyMULT users need to use V 7.51 or later. This is
  302.     more reliable than previous version of finding NODE number. make sure you
  303.     DELETE your CURRUSER.BBS if you have it laying around from a previous version
  304.     file  before converting the .bat file! or it will use the same CURRUSER.BBS
  305.     file over and over again! Node version can now be run from DOS.
  306.       NOW run's on COM's 1 - 4!!!! it uses the 'Standard' addresses for COM3 &
  307.     COM4-$3E8 & $2E8 respectively. If you use other address for COM3 & COM4 let
  308.     me know what they are and I can make a special copy with them for you-if
  309.     you register, I've put to much into this little project with very little
  310.     return..  I need money for tuition badly!!
  311.  
  312. easy command line referance section
  313.      LASTON Pn        <pause screen n seconds>
  314.      LASTON COMMENT   <will display appropriate comment file.>
  315.      LASTON OFF       <Turns off local display for faster remote display>
  316.      LASTON /n        <registered version only. Display n users>
  317.      LASTON DOS       <Use to create .CFG file when register or to run
  318.                        from dos>
  319.      LASTON 24HR      <displays time in 24 Hour military time>
  320.      LASTON DOR       <Uses the DORINFO1.DEF user file instead of CURRUSER.(x)>
  321.      LASTON %1NODE    <A must for Multi node users- Takes the correct node # in
  322.                         FIRST.BAT, and all batch files. MUST be first parameter>
  323.      LASTON PAUSE     <will pause output at end of display>
  324. **   LASTON LOCKEDRATE<Will use the locked rate instead of actual rate for high
  325.                        speed connections>
  326. **   LASTON LOGP/n    <only set if you don't use DAT command and you get a NOT
  327.                        ENOUGH USERS IN CALLERS.LOG error. n=5 by default.
  328.                        Increase from n=5 till error disappears>
  329. **   LASTON DAT       <Tells laston to make(if not present) and use the
  330.                                                          LASTON.DAT file>
  331.      LASTON MENU      <For use with DAT command when run from a menu>
  332.         All parameters are optional EXCEPT for the %1 parameter for multi-node
  333.      users. Parameters can be used together in any order.
  334.  
  335.      REGISTRATION BENIFITS are- Add your BBS name to header, get rid of the 3
  336.   lines of advertisement before list(will still display copywrite notice after
  337.   display), ability to change amount of users listed, ability to mark users as
  338.   new, paid, or whatever you want, change field colors- i.e. change color of
  339.   name, baud, etc...
  340.  
  341.        This program was written for RyBBS only on a 386 AT and tested
  342.     on a XT clone... it was tested using COM ports COM1 & COM2 & COM3..
  343.          Can also use Dorinfo1.def file!!
  344.       It was also run successfully on a 486... if you test this on
  345.     anything else successfully not listed here- other machines Please let me
  346.     know!..  why not try some other programs such as
  347.             ANSED, DOORECHO, NECKTI!...... available on RYBBS homebase!(RyBBS specific)
  348.                                                (414)962-1097  9600 baud
  349.             and on EXEC-PC (414)789-4210  over 200 lines!
  350.  
  351.            To register for the added options send $15 to
  352.                   Douglas DeLonay
  353.                   P.O. BOX 72112
  354.                   Milwaukee, WI 53212
  355.  
  356.            along with any suggestions or comments you may have.
  357.            also indicate if you want you registration number sent
  358.            by US mail, E-MAIL on Homebase or on The Home of ZIGGY
  359.                        (414)264-3220
  360.  
  361.                  Thanks for your support!
  362.  
  363.